obexd Agent API description
**********************************

Copyright (C) 2007-2008  Nokia Corporation
Copyright (C) 2007-2008  Instituto Nokia de Tecnologia (INdT)
Copyright (C) 2007-2008  Marcel Holtmann <marcel@holtmann.org>


Agent hierarchy
===============

Service		unique name
Interface	org.openobex.Agent
Object path	freely definable

Methods
		string Authorize(object transfer, string bt_address, string name,
					string type, int32 length, int32 time)

			This method gets called when the service daemon
			needs to accept/reject a Bluetooth object push request.
			Returns the full path (including the filename) where
			the object shall be stored.

			Possible errors: org.openobex.Error.Rejected
			                 org.openobex.Error.Canceled

		void Cancel()

			This method gets called to indicate that the agent
			request failed before a reply was returned. It cancels
			the previous request.